home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Development / General / MacMETH3.2.1 Folder / MacMETH3.2.1 Disk 1⁄2 / 00_README.MacMETH < prev    next >
Encoding:
Text File  |  1994-03-21  |  6.1 KB  |  147 lines  |  [TEXT/MEDT]
  1.  
  2.        
  3.                          ======================
  4.                          |  On MacMETH 3.2.1  |
  5.                          ======================
  6.               
  7.     A Fast Modula-2 Language System for the Apple(R) Macintosh(R)
  8.     -------------------------------------------------------------
  9.  
  10. This is the "Fast Modula-2 Language System for the Apple(R) 
  11. Macintosh(R)" from the Eidgenoessische Technische Hochschule, ETH 
  12. Zurich, Switzerland.  
  13.  
  14. Permission to Use
  15. *****************
  16.  
  17. Permission to use, copy and distribute this software and
  18. its documentation is hereby granted without fee, provided
  19. that the above copyright notice appears in all programs and
  20. documents and that the full text of this notice appears on all
  21. copies on printed and electronic media, and provided that no
  22. charge is made for such use and distribution apart from that
  23. necessary to cover reproduction costs.
  24. The name of the ETH may not be used in advertising or publicity
  25. pertaining to this software and or documentation without
  26. specific written prior permission of the copyright holder.
  27. ETH makes no representations about the suitability of this
  28. software for any purpose whatsoever. It is provided "as is"
  29. without express or implied warranty.
  30.  
  31.  
  32. ETH DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
  33. SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
  34. MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ETH
  35. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
  36. DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  37. LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  38. CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
  39. OUT OF OR IN  CONNECTION WITH THE USE OR PERFORMANCE
  40. OF THIS SOFTWARE.
  41.  
  42.  
  43. Availability
  44. ************
  45.  
  46. Get the newest version and a full documentation of this package from 
  47. anonymous FTP (Password: <your name>@<your locality> ):
  48.   
  49.        neptune.inf.ethz.ch (129.132.101.33) 
  50.        
  51. Preferably you transfer the file "MacMETH 3.2.1.sea" (e.g. by means 
  52. of "VersaTerm FTP client", MacBinary format) or transfer the file 
  53. "MacMETH 3.2.1.hqx" (BinHex 4.0 format) instead.  The latter needs 
  54. first to be converted into its binary form by the utility "BinHex 
  55. 4.0" (available from many user groups).  In any case you will end 
  56. up with the file "MacMETH 3.2.1.sea" (the extension 'sea' stands for 
  57. Self Extracting Application).  
  58.  
  59. Double-click "MacMETH 3.2.1.sea" and specify in the subsequent dialog 
  60. that the resulting folders shall be written to your hard disk.  You 
  61. will get two folders named "MacMETH 3.2.1 Disk 1/2" and "MacMETH 3.2.1 
  62. Disk 2/2".  Each of these folders fits on a 800K floppy disk for 
  63. distribution or transportation via diskettes.             
  64.  
  65. "MacMETH 3.2.1 Disk 1/2" contains everything which is needed to work 
  66. through the examples given in the manual and to develop programs. 
  67.  
  68. "MacMETH 3.2.1 Disk 2/2" contains extras which need to be accessed 
  69. only occasionally. Among others it contains a copy of this file, a 
  70. printable copy of the manual, and some tools and files which may be 
  71. of use when special options are of interest.  For instance there is 
  72. a pair of alternative compilers, i.e. CompileN respectively 
  73. Compile20N, which follow strictly the Modula-2 report in "Wirth,N., 
  74. 1988. Programming in Modula-2, 4th ed.", or if you wish to compile 
  75. new macros for MEdit, or if you are interested in the Hennessy 
  76. benchmark programs etc.      
  77.  
  78.  
  79. Questions
  80. **********
  81. Please send questions, comments and bug reports to:
  82.    macmeth@ito.umnw.ethz.ch
  83.  
  84.  
  85. Getting started
  86. ***************
  87.  
  88. Make a working copy of all files and folders contained on diskette 
  89. "MacMETH 3.2.1 Disk 1/2" into a folder, e.g. named "M2", on your hard 
  90. disk or another diskette.   Make sure you have at least 32K of disk 
  91. cache.  Then start the shell " MacMETH 3.2.1", select "Compile", then 
  92. select "Execute" to execute the just compiled file by selecting the 
  93. file "Example.OBM" in the folder "Examples".     See what happens!    
  94.  
  95. To install the content of "MacMETH 3.2.1 Disk 2/2" perform the
  96. following steps:
  97. Copy the files of the  "More XYZ" folders into the respective folder
  98. "XYZ" in your "M2" installation.
  99. Copy the "MEdit f" folder and "MacMETH Manual 1992.sea" into your "M2"
  100. folder.  Double-click  "MacMETH Manual 1992.sea"  and specify in the
  101. subsequent  dialogue that the  resulting folders shall be written to
  102. your "M2" folder.
  103.  
  104. The XYZ.sea files are not needed anymore after completion of
  105. installation. 
  106.  
  107. For further instructions see the MacMETH manual.    
  108.  
  109. Note:  If you start the editor " MEdit 1.80", e.g. via selecting 
  110. the menu command Edit2 from within the MacMETH shell, please follow 
  111. the configuration dialog by entering your last and first name and 
  112. clicking 'Ok' for all the rest of the dialog.  This allows you to 
  113. easily switch back and forth between the MacMETH shell and MEdit 
  114. via the menu commands " MacMETH 3.2.1 - File/Edit2" respectively " 
  115. MEdit 1.80 - Macros/Launch M2 shell".  
  116.  
  117.  
  118.  
  119. ---------------------------------------------------------------------  
  120. An Important Note on Processes and Coroutines
  121. *********************************************
  122.  
  123. The low-level facilities for coroutines and the procedures NEWPROCESS
  124. and TRANSFER are NOT implemented in the MacMETH 3.2.1 Release, and they
  125. will NOT be implemented in forthcoming releases.
  126.  
  127. The current MacMETH Manual 1992 is misleading in promising a future
  128. implementation within a separate module.
  129.  
  130. Older MacMETH Releases provided a very simple and fast solution in
  131. form of a separate module: the System Stack Pointer was modified
  132. freely and assigned to the workspace of the corresponding process.
  133.  
  134. However, the Macintosh System requires one and only one System Stack!
  135. And newer Macintosh Systems DO CHECK for this requirement. On the
  136. other hand, the possibility to have different (system) stacks is a
  137. Sine-Qua-Non-Condition for a reasonable implementation of coroutines.
  138. From this point of view, the Macintosh Toolbox and coroutines with
  139. different stacks are very controversial.
  140.  
  141. As a consequence, our (old) solution does NOT work anymore: it is
  142. no more possible to modify freely the System Stack Pointer and to
  143. assign it to a workspace, which lies either in the programs global
  144. data area or within MacMETH's heap space.
  145. ---------------------------------------------------------------------  
  146.  
  147. jth 3/21/1994